Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add documentation to musig2 functions #97

Merged
merged 2 commits into from
Jan 22, 2024
Merged

Conversation

t-bast
Copy link
Member

@t-bast t-bast commented Jan 22, 2024

Usage of the Musig2 functions isn't intuitive at all, especially with the key aggregation cache and session data. It's useful to provide accurate documentation to help users understand how to correctly produce musig2 signatures. It took me some back and forth between our code and secp256k1 to figure out how some of the functions worked.

We also change argument names to match Kotlin best practices instead of using the same argument names as C functions, and add more tests.

⚠️ this PR targets the #93 branch

Usage of the Musig2 functions isn't intuitive at all, especially with
the key aggregation cache and session data. It's important to provide
accurate documentation to help users understand how to correctly produce
musig2 signatures.

We also change argument names to match Kotlin best practices instead of
using the same argument names as C functions.
@t-bast t-bast requested a review from sstone January 22, 2024 10:50
@t-bast t-bast mentioned this pull request Jan 22, 2024
Copy link
Member

@sstone sstone left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nice! Just a few suggestions.

src/commonMain/kotlin/fr/acinq/secp256k1/Secp256k1.kt Outdated Show resolved Hide resolved
src/commonMain/kotlin/fr/acinq/secp256k1/Secp256k1.kt Outdated Show resolved Hide resolved
@t-bast t-bast merged commit 7b9c200 into snapshot/musig2 Jan 22, 2024
6 checks passed
@t-bast t-bast deleted the snapshot/musig2-bast branch January 22, 2024 15:13
sstone pushed a commit that referenced this pull request Jan 23, 2024
Usage of the Musig2 functions isn't intuitive at all, especially with
the key aggregation cache and session data. It's important to provide
accurate documentation to help users understand how to correctly produce
musig2 signatures.

We also change argument names to match Kotlin best practices instead of
using the same argument names as C functions.
sstone pushed a commit that referenced this pull request Jan 23, 2024
Usage of the Musig2 functions isn't intuitive at all, especially with
the key aggregation cache and session data. It's important to provide
accurate documentation to help users understand how to correctly produce
musig2 signatures.

We also change argument names to match Kotlin best practices instead of
using the same argument names as C functions.
sstone added a commit that referenced this pull request Feb 14, 2024
* Use Jonas Nick's musig2 branch

* Reformat c code (no functional changes)

* Implement musig2

* Add documentation to musig2 functions (#97)

Usage of the Musig2 functions isn't intuitive at all, especially with
the key aggregation cache and session data. It's important to provide
accurate documentation to help users understand how to correctly produce
musig2 signatures.

We also change argument names to match Kotlin best practices instead of
using the same argument names as C functions.

* Add musig2 reference tests (no functional changes)

---------

Co-authored-by: Bastien Teinturier <31281497+t-bast@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants